办公聊天软件接入 Hermes Agent 实录（零）：为什么做、怎么选、三篇地图
本系列基于 Hermes Agent（v0.20.0）+ Dify（1.16.1）实测，三篇文章分别对应企业微信、飞书、钉钉的完整接入实录。
为什么做这件事
很多企业有这样的需求：把企业的 AI 能力变成「聊天窗口里随叫随到的 AI 助手」——员工在钉钉/飞书/企业微信里直接问「产品手册里 XX 怎么配置」「帮我查一下订单状态」「生成这周的工作汇报」，机器人秒回、回答还带引用，能追溯到来源。
这里说的「AI 能力」不只是知识库问答，也包括业务流程工作流（订单查询、审批、报表生成……）——聊天软件只是入口，背后接什么业务能力都行。本系列以知识库问答为例演示（最直观、最容易上手），但同一套链路换成其他工作流应用完全一样。
我们当时接这个需求的第一反应，其实是「要不要自建一个 App」——做完方案对比才想明白：员工不会为了一个 AI 助手去安装新 App，但他天天开着企业微信。比打开网页查文档自然得多，也比自建一套 App 轻得多——办公软件已经在用，业务系统已经存在，要做的只是把它们接起来。
共同架构（三篇同一套）
WebSocket 长连接] E[Hermes Agent
会话管理/用户身份/权限] end subgraph Dify 编排层 F[Dify 知识库
RAG 检索] G[Dify 工作流
审批/工单/复杂逻辑] end A & B & C -->|消息推送| D D -->|调用 MCP 工具| E E -->|查询| F E -->|触发| G F & G -->|返回结果| E E -->|格式化回复| D D -->|回推消息| A & B & C
如图所示，我们采用**「Hermes 负责连接与执行，Dify 负责知识与编排」的分层解耦架构**：Hermes 屏蔽了企业微信、飞书、钉钉三大平台的底层差异（长连接/事件订阅/身份映射），Dify 提供 RAG 检索和可视化工作流编排能力，两者通过 HTTP/MCP 协议无缝对接。前端用哪款聊天软件，后端是同一套——三篇的区别只在「前端平台怎么接」，后端完全一致。
为什么不直连？为什么要加 Hermes 这一层？
有人会问：Dify 官方也支持接入飞书/钉钉，为什么还要中间加一个 Hermes？
直接让 Dify 对接多个聊天软件，会遇到三个现实问题：
会话状态不一致——每个平台各自维护会话，员工在企微问了一半、切到飞书继续问，上下文对不上
用户身份割裂——同一个员工在企微/飞书/钉钉是三个不同 ID，权限控制、审计追踪都断链
无法调用本地能力——Dify 跑在云端，调用 Shell、本地文件、内部系统这类「终端执行」能力受限
加 Hermes 作为唯一网关后：三平台事件订阅统一收口、用户身份统一映射（一个大脑认一个人）、会话按平台隔离且可跨平台管理；Dify 专注它最擅长的知识检索和业务编排。Hermes 管连接与执行，Dify 管知识与编排——各干各的，互不替代。
三篇怎么选
| 篇 | 平台 | 接入路线 | 适合谁 |
|---|---|---|---|
| （一） | 企业微信 | 智能机器人长连接（极简） | 想要最少配置快速跑通；还想了解「一个机器人调多个 Dify 应用」 |
| （二） | 飞书 | 权限矩阵 + 事件订阅 + 版本发布（完整配置） | 用飞书办公；想理解聊天软件接入的完整机制 |
| （三） | 钉钉 | Stream 模式长连接（个人开发者友好） | 用钉钉办公；没有企业资质、想用个人账号自建的开发者 |
系列文章列表
| 序号 | 标题 | 主题 | 链接 |
|---|---|---|---|
| 零 | 办公聊天软件接入 Hermes Agent 实录（零）：为什么做、怎么选、三篇地图 | 系列总览（本篇） | 本文 |
| 一 | 办公聊天软件接入 Hermes Agent 实录（一）：企业微信 WebSocket 长连接 + Dify 知识库问答（v0.20.0 实测） | 极简路线 + 多 Dify 应用 + 架构原理 | 发布后贴链接 |
| 二 | 办公聊天软件接入 Hermes Agent 实录（二）：飞书权限矩阵 + 长连接事件订阅一次跑通（v0.20.0 实测） | 完整配置路线（权限/事件订阅/发布三件套） | 发布后贴链接 |
| 三 | 办公聊天软件接入 Hermes Agent 实录（三）：钉钉 Stream 模式长连接零公网跑通（个人开发者也能接，v0.20.0 实测） | 个人开发者路线 + Stream 长连接 | 发布后贴链接 |
阅读建议
第一次接触：按（一）→（二）→（三）顺序读——企微篇最易上手，飞书篇把配置机制讲透，钉钉篇补个人开发者视角
只关心某个平台：直接读对应篇，每篇自成完整闭环
想了解原理：企微篇的架构节讲得最全（Dify 应用即 API、工具化认知、两层质量）
环境说明
Hermes Agent v0.20.0（开源 AI Agent 框架，支持多聊天软件接入）
Dify 1.16.1（开源 LLM 应用开发平台，知识库问答）
云服务器：腾讯云轻量（Ubuntu 24.04，Docker 部署 Dify）
三篇全部实测跑通：企业微信、飞书、钉钉三平台可同时在线（一个 Hermes 大脑、三个聊天软件入口），会话按平台天然隔离互不干扰。
本文由 AI 协作完成：接入、排障、优化均为实测过程，数据取自真实运行日志。有问题欢迎评论区交流。
